InvokeKCCallbackUPP

InvokeKCCallbackUPP
Header:	Keychain.h		Carbon status:	Under Evaluation

Invokes your keychain event callback.

OSStatus InvokeKCCallbackUPP (
    KCEvent keychainEvent, 
    KCCallbackInfo *info, 
    void *userContext, 
    KCCallbackUPP userUPP
);

Parameter descriptions

keychainEvent: The keychain events you want your application to receive. See “Keychain Event Constants” for a description of possible values. The Keychain Manager tests the bitmask you pass in the eventMask parameter of the function KCAddCallback to determine which events to pass to your callback function. See “Keychain Event Mask Constants” for a description of this bitmask.
info: A pointer to a structure of type KCCallbackInfo that provides information about the keychain event to your callback function. The Keychain Manager passes a pointer to this structure in the info parameter of your callback function.
userContext: A pointer to application-defined storage. The Keychain Manager passes this value in the userContext parameter of your callback function. Your application can use this to associate any particular call of InvokeKCCallbackUPP with any particular call of the keychain event callback function.
userUPP: A Universal Procedure Pointer to your keychain event callback function. For information on how to create a keychain event callback function, see KCCallbackProcPtr.

function result: A result code.

DISCUSSION

The Keychain Manager calls the InvokeKCCallbackUPP function when you pass a UPP to your callback function in the callbackProc parameter of the function KCAddCallback, and the keychain event that you specified in the eventMask parameter occurs.

VERSION NOTES

Available beginning with Keychain 1.0.